Skip to main content

2.1.2. Querry string parametrs

Parametrs

ParameterDescriptionMandatoryTypeNotes
objOrganizationarray
shopShoparray
deviceDevicearray
terminalTerminalarray

obj Array Structure

ParameterDescriptionMandatoryTypeNotes
callback_urlURL for response callback
nameOrganization namerequiredstring
fiscal_idTax numberrequiredstring
is_legalLegal entity flagbooleandefault True
contract_numContract numberstring
contact_nameContact personstring
regionRegion namestring
cityCity namestring
districtDistrict namestring
addressOrganization addressstring
emailEmailstring
phoneOrganization phone numberstring
activitiesArray of activitiesrequiredarray

activities Array Structure

ParameterDescriptionMandatoryTypeNotes
codeActivity coderequired
nameActivity name

shop Array Structure

ParameterDescriptionMandatoryTypeNotes
shop_nameShop namerequiredstringrequired, key if code not used
shop_addressShop addressrequiredstring
shop_phoneShop phone numberstring
shop_codeShop codestringkey if used
shop_typeShop typestring

device Array Structure

ParameterDescriptionMandatoryTypeNotes
dev_modelDevice modelstringPossible values: “Smart One Bank Pro”, “Smart One Bank
serialSerial numberstring
tokenFiscal token numberstring
activated_packagesArray of activated packagesarray

activated_packages Array Structure

ParameterDescriptionMandatoryTypeNotes
date_fromStart daterequired
date_forEnd date
codePackage type coderequiredPossible values: “payment”, “payment_fiscal”, “payment_fiscal_payment
terminal_idAdditional parameter for Payment
secret_keyAdditional parameter for Payment

terminal Array Structure

ParameterDescriptionMandatoryTypeNotes
tidTerminal UIDrequiredstring
template_nameTerminal template namerequiredstringValue “TBC Base
processing_nameProcessing namerequiredstringValue “Compass+ TPTP
midOrganization UIDrequiredstringIf not found, will be added
mccOrganization category coderequiredstring
rsOrganization standardrequiredstring

Code structure

{
  "obj": { // Organization
    "callback_url": "URL for response callback", // string
    "name": "Organization name", // required, string
    "fiscal_id": "Tax number", // required, string
    "is_legal": "Legal entity flag", // boolean, default True
    "contract_num": "Contract number", // string
    "contact_name": "Contact person", // required, string
    "region": "Region name", // string
    "city": "City name", // string
    "district": "District name", // string
    "address": "Organization address", // string
    "email": "Email", // required, string
    "phone": "Organization phone number", // required, string
    "activities": [ // Array of activities, required
      {
        "code": "Activity code", // required
        "name": "Activity name" // optional
      }
    ]
  },
  "shop": { // Shop
    "shop_name": "Shop name", // required, key if code not used, string
    "shop_address": "Shop address", // required, string
    "shop_phone": "Shop phone number", // string
    "shop_code": "Shop code, key if used", // string
    "shop_type": "Shop type" // string
  },
  "device": { // Device
    "dev_model": "Device model", // string (possible values: “Smart One Bank Pro”, “Smart One Bank”)
    "serial": "Serial number", // string
    "token": "Fiscal token number", // string
    "activated_packages": [ // Array of activated packages, optional
      {
        "date_from": "Start date", // required
        "date_for": "End date",
        "code": "Package type code", // required (possible values: “payment”, “payment_fiscal”, “payment_fiscal_payme”)
        "terminal_id": "Additional parameter for Payme",
        "secret_key": "Additional parameter for Payme"
      }
    ]
  },
  "terminal": { // Terminal
    "tid": "Terminal UID", // required, string
    "template_name": "Terminal template name", // required, string (value “TBC Base”)
    "processing_name": "Processing name", // required, string (value “Compass+ TPTP”)
    "mid": "Organization UID", // required, string (if not found, will be added)
    "mcc": "Organization category code", // required, string
    "rs": "Organization standard", // optional, string
  }
}